Właściwości¶

Poniżej znajduje się kompletna liczba właściwości załączanych w bloku opisu terminfo i dostępnych dla kodu, korzystającego z terminfo. W każdej linii tabeli

Zmienna jest nazwą, poprzez którą programista (na poziomie terminfo) dostaje się do właściwości.

Nazwawłaściwości jest krótką nazwą, używaną w tekście bazy danych, a korzysta z niej osoba aktualizująca bazę. Jeśli to możliwe, nazwywłaściwości są wybierane w standardzie (przynajmniej zbliżonym do) ANSI X3.64-1979 (który jest obecnie wypierany przez ECMA-48, używającego jednak podobnych nazw). Semantyka powinna też odpowiadać specyfikacji.

Kod termcap jest starą nazwą właściwości termcap (niektóre własciwości są nowe i mają nazwy nie pochodzące z termcap).

Nazwy właściwości nie mają sztywnego limitu długości, lecz przyjęto nieformalny limit 5 znakowy, który zachowuje je w zwartej postaci i umożliwia tabulacjom w pliku Caps ładne zawijanie.

Na koniec, pole opisu próbuje przenieść semantykę właściwości. W polu opisu możesz znaleźć pewne kody:

(P)

określa, że można podać wypełnianie (padding)

#[1-9]

w polu opisu określa, że łańcuch jest przekazywany przez tparm z określonymi parametrami (#i). (patrz lib_tparm.c z pakietu ncurses--przyp. tłum.)

(P*)

określa, że wypełnianie może różnić się w zależności do liczby objętych nim linii.

(#i)

określa ity parametr.

Oto właściwości logiczne:

A oto właściwości numeryczne:

W strukturze term SVr4.0 istnieją też następujące właściwości numeryczne, lecz nie są one jeszcze udokumentowane w podręczniku. Pochodzą one z SVr4-tego wsparcia dla drukarki.

A oto właściwości napisowe:

Następujące właściwości łańcuchowe istnieją w strukturze term SVr4.0, lecz początkowo nie były opisane w podręczniku man.

Standard XSI curses dodał te oto. Pochodzą one z niektórych po-4.1 wersji curses z Systemu V, np. Solaris 2.5 i IRIX 6.x. Nazwy termcapu ncurses zostały dla nich wynalezione; według standardu XSI nie mają one nazw termcap. Jeśli twoje skompilowane wpisy terminfo ich używają, mogą one nie być binarnie kompatybilne z wpisami System V po SVr4.1; Strzeż się!

Przykładowy wpis¶

Następujący opis, przeznaczony dla terminala ANSI jest reprezentatywną próbką opisu wyglądu nowoczesnych terminali.

ansi|ansi/pc-term compatible with color,


        mc5i,


        colors#8, ncv#3, pairs#64,


        cub=\E[%p1%dD, cud=\E[%p1%dB, cuf=\E[%p1%dC,


        cuu=\E[%p1%dA, dch=\E[%p1%dP, dl=\E[%p1%dM,


        ech=\E[%p1%dX, el1=\E[1K, hpa=\E[%p1%dG, ht=\E[I,


        ich=\E[%p1%d@, il=\E[%p1%dL, indn=\E[%p1%dS, .indn=\E[%p1%dT,


        kbs=^H, kcbt=\E[Z, kcub1=\E[D, kcud1=\E[B,


        kcuf1=\E[C, kcuu1=\E[A, kf1=\E[M, kf10=\E[V,


        kf11=\E[W, kf12=\E[X, kf2=\E[N, kf3=\E[O, kf4=\E[P,


        kf5=\E[Q, kf6=\E[R, kf7=\E[S, kf8=\E[T, kf9=\E[U,


        kich1=\E[L, mc4=\E[4i, mc5=\E[5i, nel=\r\E[S,


        op=\E[37;40m, rep=%p1%c\E[%p2%{1}%-%db,


        rin=\E[%p1%dT, s0ds=\E(B, s1ds=\E)B, s2ds=\E*B,


        s3ds=\E+B, setab=\E[4%p1%dm, setaf=\E[3%p1%dm,


        setb=\E[4%?%p1%{1}%=%t4%e%p1%{3}%=%t6%e%p1%{4}%=%t1%e%p1%{6}%=%t3%e%p1%d%;m,


        setf=\E[3%?%p1%{1}%=%t4%e%p1%{3}%=%t6%e%p1%{4}%=%t1%e%p1%{6}%=%t3%e%p1%d%;m,


        sgr=\E[0;10%?%p1%t;7%;%?%p2%t;4%;%?%p3%t;7%;%?%p4%t;5%;%?%p6%t;1%;%?%p7%t;8%;%?%p8%t;11%;%?%p9%t;12%;m,


        sgr0=\E[0;10m, tbc=\E[2g, u6=\E[%d;%dR, u7=\E[6n,


        u8=\E[?%[;0123456789]c, u9=\E[c, vpa=\E[%p1%dd,

Wpisy mogą się ciągnąć na wiele linii dzięki poprzedzaniu kolejnych linii białymi spacjami (poza pierwszą linią). Komentarze można załączać w poszczególnych liniach przy użyciu ``#''. Właściwości w terminfo występują jako trzy typy: Właściwości logiczne, okreslające czy terminal ma jakąś właściwość; właściwości numeryczne, określające rozmiar terminala, opóźnień; właściwości łańcuchowe, określające sekwencje używane do dokonywania określonych operacji terminalowych.

Typy właściwości¶

Wszystkie właściwości mają nazwy. Na przykład fakt, że terminale ANSI mają automatyczne marginesy (tj. automatyczny return i lf po osiągnięciu końca linii) jest określany właściwością am. Z tej przyczyny opis ansi zawiera am. Właściwości numeryczne mają doklejony znak `#' i wartość dodatnią. Tak więc cols, określające liczbę kolumn terminala, w przypadku ansi ma `80'. Wartości właściwości numerycznych można podawać dziesiętnie, ósemkowo lub szesnastkowo, uzywając konwencji z języka C (np. 255, 0377, 0xff i 0xFF).

Właściwości napisowe, takie jak el (sekwencja czyszczenia do końca linii) są podawane w kodzie dwuznakowym--najpierw jest `=', potem łańcuch, kończącyc się znakiem `,'.

Dla łatwego kodowania znaków udostępnione są we właściwościach o wartościach łańcuchowych sekwencje specjalne. \E i \e odnoszą się do znaku ESCAPE, ^x odnosi się do control-x, a sekwencje \n \l \r \t \b \f \s odpowiadają nowej linii, line-feed, powrotowi karetki, tabulacji, kasownikowi (backspace), form-feed, i spacji. Inne sekwencje specjalne to m.in. \^ dla ^, \\ dla \, \, dla przecinka, \: dla :, i \0 for zera (null). (\0 daje \200, co nie kończy łańcucha, lecz zachowuje się jak znak null na większości terminali o ile podane jest CS7. Zobacz stty(1).) Znaki mogą być też podawane jako trzy cyfry ósemkowe po \.

We właściwości łańcuchowej może występować opóźnienie, wyrażone w milisekundach. Jest ono ujmowane w nawiasy $<..>, np. el=\EK$<5>. Znaki wypełnienia, zapewniające opóźnienie produkuje tputs. Opóźnienie musi być liczbą o maksymalnie jednym miejscu precyzji dziesiętnej; może zawierać przyrostki `*', `/' lub obydwa. `*' znaczy, że wymagane wypełnienie jest proporcjonalne do liczby linii, których dotyczy operacja, a podany rozmiar wymagany jest na każdą "dotkniętą jednostkę". (w przypadku wstawiania znaku, współczynnik jest wciąż liczbą dotkniętych linii.) Zazwyczaj wypełnianie jest zalecane jeśli urządzenie ma właściwość xon; jest ono [wtedy] używane do obliczania kosztów, lecz nie wywołuje opóźnień. Znak `/' wskazuje, że wypełnianie jest obowiązkowe i wymusza opóźnienie danej liczby milisekund, nawet na urządzeniach, w których obecne jest xon, określające sterowanie przepływu.

[Wypełnianie jest używane na starych, wolnych terminalach bez sterowania przepływem. Istnieje dlatego, że gdy nie ma sterowania, bufory wejściowe urządzenia mogą się przepełnić i pewne znaki mogą się zgubić. Wypełnienie takiego niepewnego okresu nieznaczącymi znakami wypełnienia zapewnia, że istotne informacje nie zostaną utracone--utracone zostaną jedynie ignorowane znaki wypełnienia. (przyp. tłum.)]

Czasem pewne właściwości muszą być wykomentowane. Aby to zrobić, wystarczy przed nazwą umieścić kropkę. Na przykład zrobiono tak w drugim ind z powyższego przykładu.

Pobieranie skompilowanych opisów¶

Jeśli ustawiona jest zmienna środowiskowa TERMINFO, to jest ona używana jako ścieżka do katalogu, zawierającego skompilowany opis tego, nad czym pracujesz. Przeszukiwany jest tylko ten katalog.

W przeciwnym przypadku, wersja ncurses czytnika terminfo będzie szukać skompilowanego opisu w katalogu $HOME/.terminfo. Jeśli nic tam nie będzie, dalsze poszukiwania polecą według zmiennej środowiskowej TERMINFO_DIRS (zawierającej rozdzieloną dwukropkami listę katalogów) (pusty wpis jest rozumiany jako komenda szukania /usr/share/terminfo). Jeśli i tu nic nie zostanie znalezione, pobieranie kończy się niepowodzeniem.

Jeśli nie ustawiono ani TERMINFO, ani TERMINFO_DIRS, szukanie odbędzie się w systemowym katalogu terminfo, /usr/share/terminfo.

(Pod curses z Systemu V nie są obsługiwane pliki $HOME/.terminfo ani zmienna TERMINFO_DIRS.)

Przygotowywanie opisów¶

Wyjaśnimy teraz jak przygotowywać opisy terminali. Najefektywniejszym sposobem jest wykorzystanie podobnego terminala z terminfo i budowanie opisu stopniowo, wykorzystując częściowe opisy z użyciem vi lub innego zorientowanego ekranowo programu, sprawdzając je w ten sposób. Miej świadomość, że nietypowy terminal może wykazywać ubytki w stosunku do opisującego go pliku terminfo lub, że kod testującego programu jest nieprawidłowy.

Aby ustawić prawidłowo wypełnianie (padding) dla wstawiania linii (jeśli producent terminala tego nie udokumentował), można wykonać test: edytuj duży plik przy 9600 bodów, następnie skasuj ok. 16 linii ze środka ekranu, potem naciśnij kilka razy szybko `u'. Jeśli terminal się zaśmieci, wymagane jest większe wypełnianie. Podobny test można zrobić do wstawiania znaku.

Podstawowe właściwości¶

Liczba kolumn terminala jest określana właściwością numeryczną cols. Jeśli terminal jest CRT, to liczba linii ekranu jest podawana we właściwości lines. Jeśli terminal zawija linie po dojściu do prawego marignesu, to powinien posiadać właściwość am. Jeśli terminal może czyścić swój ekran, pozostawiając kursor w pozycji domowej, to powinno to być określone przez właściwość łańcuchową clear. Jeśli terminal wykonuje nadstukiwanie (a nie czyści pozycji nadstukiwanej), to powinien posiadać właściwość os. Jeśli terminal jest terminalem drukującym, bez jednostki soft copy, to powinien mieć zarówno hc jak i os. (os dotyczy terminali z zakresem przechowywania, jak w serii TEKTRONIX 4010 ale także czy w terminalach hardcopy i APL.) Jeśli istnieje kod, przenoszący kursor do lewego krańca bieżącego wiersza, to powinien być on podany jako cr. (Zwykle jest to powrót karetki, control M.) Jeśli istnieje kod dzwonka (bell, beep, itp.), to powinien być on podany jako bel.

Jeśli istnieje kod, przesuwający kursor o jedną pozycję w lewo (jak backspace), to właściwość ta powinna być podana jako cub1. Podobnie, kod przesuwający w prawo, górę i dół powinien być podany jako cuf1, cuu1, i cud1. Te lokalne ruchy kursora nie powinny zmieniać tekstu, który mijają, np. normalnie nie używa się `cuf1= ', gdyż spacja skasowała by znak.

Ważnym spostrzeżeniem w tym momencie jest fakt, że lokalne ruchy kursora, zakodowane w terminfo nie są zdefiniowane w lewych i górnych krańcach terminala CRT. Programy nie powinny więc używać backspace na lewym krańcu, chyba że podane jest bw. Podobnie, nie powinny próbować iść w górę z pierwszej linii. Aby przewinąć tekst do góry, program powinien przejść do dolnego, lewego narożnika ekranu i wysłać łańcuch ind (index).

Aby przewinąć tekst w dół, program idzie do lewego górnego narożnika i wysyła łańcuch ri (reverse index). Łańcuchy ind i ri nie są zdefiniowane w przypadku przebywania w nieodpowiednich miejscach ekranu.

Wersjami parametryzowanymi sekwencji przewijających są indn i rin, które mają taką samą semantykę jak ind i ri, lecz dodatkowo pobierają parametr i przewijają tyle właśnie linii. Są one również niezdefiniowane w nieodpowiednich obszarach ekranu.

Właściwość am mówi czy kursor trzyma się prawego krańca ekranu po wysłaniu tekstu, lecz niekoniecznie tyczy się cuf1 z ostatniej kolumny. Jedyny ruch lokalny, który jest zdefiniowany z lewego krańca przy podaniu bw to cub1, który przejdzie do prawego krańca poprzedniego wiersza. Jeśli bw nie jest podane, efekt jest niezdefiniowany. Jest to przydatne np. do rysowania ramki wokół krańców ekranu. Jeśli terminal ma przełączaną właściwość automatycznych marginesów, to plik terminfo zwykle przyjmuje, że jest ona włączona, tj. am. Jeśli terminal ma polecenie, które przechodzi do pierwszej kolumny następnej linii, to komenda ta może być podana jako nel (nowa linia). Nie ma znaczenia czy polecenie to czyści resztę bieżącej linii, więc jeśli terminal nie posiada cr i lf to może wciąż uda się złożyć z czegoś działający nel.

Właściwości te wystarczają do opisania terminala hard-copy i “glass-tty”. W konsekwencji, model teletype 33 jest opisany jako

	33|tty33|tty|model 33 teletype,
	bel=^G, cols#72, cr=^M, cud1=^J, hc, ind=^J, os,

a Lear Siegler ADM-3 jako

	adm3|3|lsi adm3,
	am, bel=^G, clear=^Z, cols#80, cr=^M, cub1=^H, cud1=^J,
	ind=^J, lines#24,

Łańcuchy parametryzowane¶

Adresowanie kursora i inne łańcychy wymagające parametrów terminala są opisaywane przez właściwość parametryzowanego łańcucha, w której występują sekwencje specjalne typu printf(3S), jak %x. Na przykład aby adresować kursor, podana jest właściwość cup, używająca dwóch parametrów: wiersza i kolumny adresowania. (wiersze i kolumny sa numerowane od zera i odnoszą się do fizycznego ekranu, widzianego przez użytkownika, a nie do niewidzialnego obszaru pamięci.) Jeśli terminal posiada związane z pamięcią adresowanie kursora, to może to być wskazywane przez mrcup.

Mechanizm parametrów używa stosu i specjalnych kodów % do jego obsługi. Zazwyczaj sekwencja powoduje wepchnięcie jednego z parametrów na stos, a następnie jego wydrukowanie w pewnym formacie. Często wymagane są bardziej złożone operacje.

Kodowania % mają następujące znaczenia:

	%%	daje `%'
	%[[:]flagi][szerokość[.precyzja]][doxXs]
		podobnie jak w printf, flagi to [-+#] i spacja
	%c	drukowanie pop() daje %c
	%p[1-9]	wepchnij i'ty parm
	%P[a-z]	ustaw zmienną dynamiczną [a-z] na pop()
	%g[a-z]	pobierz dynamiczną zmienną [a-z] i wepchnij ją
	%P[A-Z]	ustaw zmienną statyczną [a-z] na pop()
	%g[A-Z]	pobierz zmienną statyczną [a-z] i wepchnij ją
	%'c'	stała znakowa c
	%{nn}	stała całkowita nn
	%l	wepchnij strlen(pop)
	%+ %- %* %/ %m
		 arytmetyka (%m to mod): push(pop() op pop())
	%& %| %^	operacje bitowe: push(pop() op pop())
	%= %> %<	operacje logiczne: push(pop() op pop())
	%A, %O	operacje logiczne and i or (dla warunków)
	%! %~	jednoargumentowe operacje push(op pop())
	%i	dodaj 1 do pierwszych dwóch parm (terminale ANSI)
	%? expr %t częśćthen %e częśćelse %;
		if-then-else, %e częśćelse jest opcjonalna.
		Dopuszalne są else-if a'la Algol 68:
		%? c1 %t b1 %e c2 %t b2 %e c3 %t b3 %e c4 %t b4 %e %;
		ci są warunkami, bi są ciałami.

Operacje binarne są w postaci postfiksowej, z operandami w typowej kolejności. Znaczy to, że aby uzyskać x-5, można użyć "%gx%{5}%-". Zmienne %P i %g są stałe podczas analizy łańcucha specjalnego.

Rozważ GP2645, w którym aby dostać się do 3 wiersza i 12 kolumny należało wysłać \E&a12c03Y, wypełnionego na 6 milisekund. Zauważ, że kolejność wierszy i kolumn jest tu w inwersji i że są one drukowane jako dwie cyfry. W efekcie jego właściwość cup to “cup=6\E&%p2%2dc%p1%2dY”.

Microterm ACT-IV wymaga poprzedzenia bieżącego wiersza i kolumny znakiem ^T i zakodowania wiersza i kolumny binarnie, “cup=^T%p1%c%p2%c”. Terminale, używające “%c” muszą być w stanie cofnąć (backskpace) kursor (cub1) i przesuwać go o jedną linię w górę na ekranie (cuu1). Jest to konieczne, gdyż nie zawsze bezpiecznie jest transmitować \n, ^D i \r, ponieważ system może je zmienić lub pominąć. (funkcje biblioteczne, obsługujące terminfo ustawiają tryby tty tak, aby tabulacje nigdy nie były rozwijane, więc \t może wysyłać bez obaw. Jest to sprawa pierwszej wagi dla Ann Arbor 4080.)

Ostatnim przykładem jest LSI ADM-3a, który używa offsetów wiersza i kolumny ze spacją, “cup=\E=%p1%' '%+%c%p2%' '%+%c”. Po wysłaniu `\E=', pierwszy parametr jest wpychany na stos, wpychana jest wartość ASCII dla spacji (32), są one następnie dodawane (wpychanie na stos ich sumy i zamiana dwóch poprzednich wartości) i produkowane jako znak. Następnie to samo jest wykonywane dla drugiego parametru. Możliwe są również bardziej złożone działania arytmetyczne na stosie.

Ruchy kursora¶

Jeśli terminal posiada szybki sposób na zerowanie pozycji kursora (na lewy górny narożnik ekranu), to może to być podane jako home; podobnie, szybkim sposobem dostania się do dolnego lewego narożnika jest ll; może to wykonywać przejście w górę z pomocą cuu1 z pozycji zerowej, lecz program samodzielnie nie powinien tego robić (chyba że ll tak robi), gdyż aplikacja nie może nic zakładać o rezultacie przejścia w górę z pozycji zerowej. Zauważ, że zerowanie pozycji jest równoważne adresowaniu na (0,0): na lewy górny narożnik ekranu, a nie pamięci. (Z tej przyczyny sekwencja \EH terminali HP nie może być używana jako home.)

Jeśli terminal posiada bezwzględne (absolute) adresowanie wierszy lub kolumn, to może to być podane jako pojedyncze właściwości parametryczne, hpa (bezwzględna pozycja pozioma) i vpa (bezwzględna pozycja pionowa). Czasami są one krótsze niż bardziej ogólne sekwencje dwuparametrowe (np. dla hp2645) i mogą być używane chętniej niż cup. Jeśli istnieją sparametryzowane ruchy lokalne (np. przesuń n spacji w prawo), to mogą być one podane jako cud, cub, cuf i cuu z pojedynczym parametrem, określającym ilość spacji przesunięcia. Sekwencje te są przydatne jeśli terminal nie ma cup, tak jak np. TEKTRONIX 4025.

Jeśli terminal podczas przcy z programem, używającym właściwości musi być w specjalnym trybie działania, to kody wchodzenia i wychodzenia z tego trybu mogą być podane jako smcup i rmcup. Przyszło to m.in. z terminali takich jak Concept, który miał więcej niż jedną stronę pamięci. Jeśli terminal ma tylko związane z pamięcią adresowanie kursora (a nie związane z ekranem) to jednoekranowe okno musi być poprawione w celu wymuszenia poprawnego działania adresowania kursora. Jest to używane również dla TEKTRONIX 4025, gdzie smcup ustawia znak komendy na ten, używany przez terminfo. Jeśli sekwencja smcup nie odtworzy ekranu po wysłaniu sekwencji rmcup (do stanu sprzed wysłania rmcup), podaj nrrmc.

Czyszczenie obszarów¶

Jeśli terminal może czyścić ekran od bieżącej pozycji do końca linii, pozostawiając kursor na swoim miejscu, to powinno to być określone jako el. Jeśli terminal może czyścić ekran od końca linii, do bieżącej pozycji, pozostawiając kursor na miejscu, to powinno to być określone jako el1. Jeśli terminal może czyścić ekran od bieżącej pozycji do końca wyświetlacza, to powinno to być określane jako ed. Ed jest zdefiniowane jedynie dla pierwszej kolumny linii. (Może więc być symulowane przez żądanie kasowania wielkiej liczby linii jeśli prawidziwe ed nie jest dostępne.)

Wstawianie/kasowanie linii i ruchy pionowe¶

Jeśli terminal może otworzyć nową pustą linię przed linią, w której znajduje się kursor, to powinno to być okreslone jako il1; jest to obsługiwane tylko z pierwszej pozycji w linii. Kursor musi potem pojawić się na nowej, pustej linii. Jeśli terminal może kasować linię, na której znajduje się kursor, to powinno to być określone przez dl1; może to być obsługiwane tylko z pierwszej pozycji na kasowanej linii. Wersje il1 i dl1, które mogą pobierać parametr, określający ile linii skasować lub wstawić, mogą być podawane jako il i dl.

Jeśli terminal ma ustawialny region przewijania (jak vt100), to komenda ustawiająca to może być opisana z pomocą właściwości csr, pobierającej dwa parametry: górną i dolną linię regionu przewijania. Pozycja kursora jest po użyciu tej komendy niestety niezdefiniowana.

Efekt wstawienia lub skasowania linii można osiągnąć z użyciem csr na odpowiednio wybranym regionie; komendy sc i rc (zachowania i odtworzenia kursora) mogą być wówczas przydatne do zapewnienia, że zestawiony łańcuch nie przesunie kursora. (Zauważ, że biblioteka ncurses(3X) dokonuje takiej syntezy automatycznie, więc nie musisz komponować łańcuchów wstawienia/skasowania z użyciem csr).

Innym sposobem tworzenia wstawiania i kasowania może być użycie kombinacji właściwości index i memory-lock, obecnych na niektórych terminalach (takich, jak HP-700/90, które jednak posiadają również insert/delete).

Wstawianie linii na górze lub u dołu ekranu może być dokonywane również z użyciem ri lub ind, co często może się okazać szybsze nawet od istniejących właściwości.

Wartość logiczna non_dest_scroll_region powinna być ustawiona jeśli każde okno przewijające jest efektywnie widokiem na obraz o rozmiarze ekranu. Aby przetestować istnienie tej właściwości, utwórz w środku ekranu region przewijania, napisz coś na dolnej linii, przesuń kursor na początek regionu i wykonaj ri, a następnie dl1 lub ind. Jeśli dane przewijane z dołu regionu ri pojawią się ponownie, to przewijanie nie jest destruktywne. Curses z Systemu V i XSI oczekują, że ind, ri, indn i rin symulują przewijanie destruktywne; ich dokumentacja ostrzega by nie definiować csr, chyba że jest to prawda. Ta implementacja curses jest bardziej liberalna i dokona jawnego kasowania po przewinięciu, jeśli zdefiniowane jest ndstr.

Jeśli terminal potrafi definiować okno jako część pamięci, która współpracuje ze wszystkimi komendami, to powinno być to określone przez parametryzowany łańcuch wind. Cztery parametry to kolejno: początkowe i końcowe linie pamięci, początkowe oraz kończące kolumny pamięci.

Jeśli terminal potrafi zachowywać pamięć wyświetlacza powyżej, to podana powinna być właściwość da; jeśli zachowana może być pamięć wyświetlacza poniżej, to podana powinna być właściwość db. Wskazują one, że kasowanie linii lub przewijanie może spowodować pojawienie się niezerowych linii z dołu i że przewijanie w tył z pomocą ri może przynieść niezerowe linie z góry.

Wstawianie/kasowanie znaku¶

Istnieją dwa podstawowe rodzaje inteligentnych terminali, jeśli brać pod uwagę obsługę wstawiania/kasowania znaków opisywaną w terminfo. Najpopularniejsze operacje wstawiania/kasowania znaków tyczą tylko znaków w bieżącej linii i sztywno przesuwają znaki w kierunku jej końca. Inne terminale, takie jak Concept 100 i Perkin Elmer Owl rozróżniają spacje wstukane i niewstukane, przesuwając przy wstawianiu/kasowaniu aż do najbliższej niewstukanej spacji, która jest następnie albo kasowana, albo rozwijana na dwie niewstukane spacje. Rodzaj terminala można określić przez wyczyszczenie ekranu i następnie wpisanie tekstu, rozdzielonego ruchami kursora. Wstukaj przy użyciu ruchów kursora (nie spacji) “abc    def”. Następnie ustaw kursor przed “abc” i włącz terminal w tryb wstawiania. Jeśli wpisywanie znaków powoduje, że reszta linii sztywno przesuwa się w prawo, to terminal nie rozróżnia spacji wstukanych od niewstukancyh. Jeśli “abc” przesunie się do “def” które następnie zacznie się posuwać wraz z nim aż do końca linii, to masz drugi rodzaj terminala. W tym wypadku powinieneś podać właściwość in, która oznacza “insert null”. Chociaż są to logicznie dwa oddzielne atrybuty (jednoliniowy vs. wieloliniowy tryb wstawiania i specjalne traktowanie niewstukanych spacji), nie znaleźliśmy terminala, którego tryb wstawiania nie mógłby zostać opisany pojedynczym atrybutem.

Terminfo może opisywać zarówno terminale posiadające tryb wstawiania, jak i terminale, które wysyłają prostą sekwencję do otwierania pustej pozycji w bieżącej linii. Jako smir podaje się sekwencję wchodzenia w tryb wstawiania. Jako rmir podaje się sekwencje do wychodzenia z trybu wstawiania. Jako ich1 podaje się sekwencję, którą należy wysłać tuż przed wysłaniem wstawianego znaku. Większość terminali z prawdziwym trybem wstawiania nie daje ich1; terminale, które wysyłają sekwencje do otwierania pozycji ekranu podają ją.

Jeśli twój terminal posiada obydwie te właściwości, to zwykle wybierany jest tryb wstawiania. Technicznie, nie powinieneś podawać obydwu, chyba że terminal wymaga ich łącznego działania. Niektóre nie-curses-owe aplikacje mogą się pogubić jeśli podane są obydwie; symptomem są podwojone znaki we wstawianiu używającym odświeżania. Wymaganie to jest obecnie rzadkie; większość sekwencji ich nie wymaga poprzedzającego smir, a większość trybów wstawiania smir nie wymaga ich1 przed każdym znakiem. Dlatego curses zakłada, że tak właśnie jest i używa albo rmir/smir albo ich/ich1 (ale nie obydwu). Jeśli musisz napisać opis dla ncurses, dla terminala, wymagającego obydwu tych działań, załącz sekwencje rmir/smir w ich1.

Jeśli po wstawieniu wymagane jest dopełnienie, podaj je jako liczbę milisekund w ip (opcja łańcuchowa). Wszelkie inne sekwencje, które wymagają wysłania po wstawieniu pojedynczego znaku również mogą być podane w ip. Jeśli twój terminal wymaga zarówno umieszczenia w `trybie wstawiania' jak i specjalnego kodu do poprzedzania każdego wstawianego znaku, to podane mogą być smir/rmir oraz ich1 i obydwie sekwencje zostaną użyte. Właściwość ich z jednym parametrem powtarza rezultat ich1 n-krotnie.

Jeśli między znakami wpisywanymi nie w trybie wstawiania wymagane jest wypełnianie, podaj je jako liczbę milisekund wypełniania w rmp(???).

Czasami konieczne jest przesunięcie się w trybie wstawiania, aby usunąć znaki z tej samej linii (np. jeśli za pozycją wstawiania znajduje się tabulacja). Jeśli twój terminal zezwala na ruchy podczas przebywania w trybie wstawiania, to powinien mieć właściwość mir, przyspieszającą w tym przypadku wstawianie. Pominięcie mir ma wpływ jedynie na szybkość. Niektóre terminale (np. Datamedia) nie mogą mieć mir, gdyż ich tryb wstawiania działa tak, że na to nie pozwala.

Do kasowania pojedynczego znaku można podać dch1, albo dch do kasowania z parametrem n, który mówi, by skasować n znaków, lub sekwencje wchodzenia (smdc) i wychodzenia (rmdc) z trybu kasowania (dowolny tryb, którego terminal wymaga dla zadziałania dch1).

Komenda do kasowania n znaków (równoważna wypuszczeniu n spacji bez przesuwania kursora) może być określona jako ech z jednym parametrem.

Podświetlanie, podkreślanie i wizualne dzwonki¶

Jeśli twój terminal ma jeden lub więcej rodzajów atrybutów wyświetlania, to mogą one być reprezentowane na wiele różnych sposobów. Jedną z postaci wyświetlacza powinieneś określić jako tryb wyróżniony (standout), reprezentujący dobry, kontrastowy, łatwy do odczytu format podświetlania komunikatów o błędach i innych rzeczy wymagających zwrócenia uwagi. (Jeśli masz wybór, to dobrym pomysłem jest inwersja kolorów plus średnie rozjaśnienie, lub też sama inwersja.) Sekwencje, przeznaczone do wchodzenia i wychodzenia z trybu wyróżnionego są podawane jako smso i rmso. Jeśli kod zmiany na tryb wyróżniony pozostawia na ekranie jedną lub dwie spacje (jak w TVI 912 i Teleray 1061), to należy podać xmc, określające ile spacji jest pozostawianych.

Kody rozpoczynania podkreślenia i jego kończenia mogą być podawane jako smul i rmul. Jeśli terminal posiada kod podkreślania bieżącego znaku i przesuwania kursora o jedną pozycję w prawo (jak w Microterm Mime), to może to być podane jako uc.

Inne właściwości wchodzenia w różne tryby podświetlenia to blink (migotanie) bold (wytłuszczenie, lub rozjaśnienie) dim (średnia-jasność) invis (tekst niewidzialny, lub `spacjowanie') prot (chronione) rev (inwersja kolorów) sgr0 (wyłącz wszystkie tryby atrybutów) smacs (wejdź w tryb alternatywnego zestawu znaków) i rmacs (wyjdź z trybu alternatywnego zestawu znaków). Włączenie dowolnego z tych trybów w pojedynkę może lub może nie wyłączyć innych trybów.

Jeśli istnieje sekwencja do ustawiania kombinacji trybów, to powinna być podana jako sgr (ustaw atrybuty), i pobierać 9 parametrów. Każdy z parametrów może być zerowy lub niezerowy, wskazując tak czy odpowieni atrybut jest włączony czy nie. 9 parametrów to kolejno: wyróżnienie, podkreślenie, inwersja, migotanie, średnia-jasność, wytłuszczenie, spacjowanie, chornienie, alternatywny zestaw znaków. Nie wszystkie tryby muszą być wspierane przez sgr, powinny być natomiast te, dla których istnieją oddzielne komendy atrybutów.

Na przykład DEC vt220 wspiera większość trybów:

Każdą sekwencję specjalną rozpoczynamy od wyłączenia wszelkich istniejących trybów, gdyż nie ma prostego sposobu na określenie czy są aktywne. Tryb wyróżnienia jest zestawiany jako kombinacja inwersji i wytłuszczenia. Terminal vt220 ma tryb ochronny, lecz nie jest on wykorzystywany w sgr, gdyż chroni również znaki ekranu przed kasowaniami stacji. Tryb alternatywnego zestawu znaków jest też inny; różni się tym, że jest albo ^O, albo ^N, zależnie czy jest wyłączony czy włączony. Jeśli wszystkie tryby są włączone, to wynikową sekwencją jest \E[0;1;4;5;7;8m^N.

Niektóre sekwencje są wspólne dla różnych trybów. Na przykład ;7 jest produkowane dla prawdziwych p1 lub p3, tj. jeśli włączony jest tryb standout lub inwersji.

Spisanie powyższych sekwencji wraz z ich zależnościami daje

Wstawienie tego wszystkiego do sekwencji sgr daje:

    sgr=\E[0%?%p1%p6%|%t;1%;%?%p2%t;4%;%?%p1%p3%|%t;7%;


        %?%p4%t;5%;%?%p7%t;8%;m%?%p9%t\016%e\017%;,

Pamiętaj, że jeśli podajesz sgr, to musisz też podać sgr0.

Terminale z ``magic cookie'' (magiczne ciasteczko) (xmc) wystawiają specjalne ``ciasteczka'' gdy odbierają sekwencje ustawiania trybu, które w zasadzie wpływają na algorytm wyświetlania, a nie na dodatkowe bity dla każdego znaku. Niektóre terminale, jak HP 2621 automatycznie wychodzą z trybu wyróżnionego gdy kursor przechodzi do nowej linii, lub gdy jest przeadresowany. Programy używające trybu wyróżnionego powinny z niego wychodzić przed przesunięciem kursora lub wysłaniem znaku nowej linii. Zwolnione mogą być z tego jedynie przy obecności właściwości msgr, zapewniającej, że przemieszczanie się w trybie wyróżnionym jest bezpieczne.

Jeśli terminal posiada mechanizm zapalania ekranu dla sygnalizacji błędu (zamiennik dzwonka), to może to być podane jako flash. Nie może to przemieszczać kursora.

Jeśli kursor może być bardziej widoczny niż zwykle, to podaj tą sekwencję jako cvvis. Jeśli istnieje sposób na uniewidzialnienie kursora, to podaj to jako właściwość civis. Właściwość cnorm powinna dawać możliwość powrotu do normalnego kursora.

Jeśli twój terminal potrafi poprawnie generować podkreślone znaki (bez specjalnych kodów), to jeśli [nawet] nie wykonuje nadstukiwania, powinieneś nałożyć na niego właściwość ul. Jeśli nadstukiwanie pozostawia widzialnym znak `pod spodem', to należy podać właściwość os. Jeśli nadstukiwania są kasowalne spacją, to powinno to być wskazane właściwością eo.

Keypad i klawisze funkcyjne¶

Jeśli terminal posiada keypad, który przesyła kody przy naciskaniu klawiszy, to można podać te informacje. Zauważ, że nie można obsługiwać terminali gdzie keypad działa tylko lokalnie (tyczy się to np. części klawiszy HP 2621). Jeśli keypad można ustawić na przesyłanie, lub nieprzesyłanie, to należy podać te kody jako smkx i rmkx. W przeciwnym wypadku zakłada się, że keypad zawsze przesyła kody. Kody przesyłane przez strzałki w lewo, prawo, górę, dół oraz klawisz home mogą być podawane jako kcub1, kcuf1, kcuu1, kcud1, i khome. Jeśli dostępne są klawisze funkcyjne, takie jak f0, f1, ..., f10, to ich kody mogą być podane jako kf0, kf1, ..., kf10. Jeśli klawisze te mają inne etykiety niż domyślne f0 do f10, to można je podać jako lf0, lf1, ...,fl10. Można również podać kody wysyłane przez inne klawisze specjalne: kll (home down), kbs (backspace), ktbc (czyść wszystkie tabulacje), kctab (czyść tabulator w tej kolumnie), kclr (klawisz czyszczenia ekranu klub wymazywania), kdch1 (klawisz kasowania (delete)), kdl1 (kasowanie linii), krmir (wyjście z trybu wstawiania), kel (czyszczenie do końca linii), ked (czyszczenie do końca ekranu), kich1 (wstaw znak, lub wejdź w tryb wstawiania), kil1 (wstaw linię), knp (następna strona (next page)), kpp (poprzednia strona (previous page)), kind (przewijaj w przód), kri (przewijaj w tył), khts (ustaw w tej kolumnie tabulator). Dodatkowo, jeśli keypad posiada tablicę 3x3 klawiszy, zawierającą 4 klawisze strzałek, to pozostałe pięć klawiszy można określić jako ka1, ka3, kb2, kc1 oraz kc3. Klawisze te są przydatne gdy potrzebne są efekty kierunkowego padu 3x3.

Łańcuchy programowania klawiszy funkcyjnych mogą być podawane jako pfkey, pfloc oraz pfx. Łańcuch do programowania etykiet ekranowych powinien być podawany jako pln. Każdy z tych łańcuchów pobiera dwa parametry: numer kalwisza funcyjnego do programowania (0 do 10) oraz łańcuch, na który go zaprogramować. Numery klawiszy funkcyjnych przekraczające ten zakres mogą programować niezdefiniowane klawisze, w sposób zależny od terminala. Różnica między właściwościami polega na tym, że pfkey powoduje iż naciśnięcie klawisza jest równoważne wklepaniu przez użytkownika danego łańcucha; pfloc powoduje, że łańcuch jest wykonywany przez terminal lokalnie; pfx powoduje, że łańcuch jest przesyłany do komputera.

Właściwości nlab, lw i lh definiują liczbę programowalnych etykiet ekranowych wraz z ich szerokością i wysokością. Jeśli istnieją komendy do wyłączania etykiet, to powinny być podane w smln i rmln. smln jest zazwyczaj wysyłane po jednej, lub większej ilości sekwencji pln, aby upewnić się, że zmiana się uwidoczni.

Tabulacje i inicjalizacja¶

Jeśli terminal posiada sprzętowe tabulacje, to komenda przejścia do następnego tabulatora może być podana jako ht (zwykle control I). Komenda ``lewej-tabulacji'', przenosząca w lewo do poprzedzającego tabulatora może być podana jako cbt. Konwencja mówi, że jeśli tryby teletype wskazują, że tabulacje są rozwijane przez komputer, a nie są przesyłane do terminala, to programy nie powinny używać ht czy cbt nawet jeśli są one obecne, gdyż użytkownik może nie mieć prawidłowo ustawionych tabulatorów. Jeśli terminal posiada sprzętowe tabulatory, które sa początkowo ustawiane co n spacji, to powinien być podany parametr numeryczny it, pokazujący odstępy między tabulatorami. Zazwyczaj jest to używane przez komendę tset do określania czy ustawiać tryb dla sprzętowego rozwijania tabulacji i czy ustawiać tabulatory. Jeśli terminal posiada tabulatory, które można zachować w nieulotnej pamięci, to opis terminfo może zakładać, że są one poprawnie ustawione.

Inne właściwości zawierają łańcuchy is1, is2 oraz is3, służące do inicjalizacji terminala, iprog, czyli ścieżkę do programu, używanego do inicjalizacji terminala oraz if, czyli nazwę pliku, zawierającego długie łańcuchy inicjalizacyjne. Łańcuchy te powinny ustawić terminal na tryby współpracujące z pozostałym opisem terminfo. Są one zwykle przesyłane do terminala poprzez opcję init programu tput przy każdym logowaniu użytkownika. Są one drukowane w następującej kolejności: uruchom program iprog; wyślij is1; is2; ustaw marginesy przy użyciu mgc, smgli smgr; ustaw tabulatory przy użyciu tbc i hts; wydrukuj plik if; i w końcu wyślij is3.

Większość inicjalizacji jest wykonywana w is2. Tryby specjalne terminala można ustawiać bez duplikowania łańcuchów, wstawiając wspólne sekwencje do is2, a specjalne elementy do is1 oraz is3. Para sekwencji, która dokonuje twardego resetu z kompletnie nieznanego stanu może być podobnie podawana jako rs1, rs2, rf i rs3, analogicznie do is2 oraz if. Łańcuchy te są wysyłane przez program reset, służący do naprawiania terminala gdy ten wejdzie w dziwny stan. Komendy zazwyczaj są umieszczane w rs1, rs2 rs3 i rf jedynie jeśli dają denerwujące efekty na ekranie i nie są konieczne podczas logowania sie. Na przykład komenda ustawiania vt100 na 80 kolumn normalnie jest częścią is2, lecz powoduje denerwujące zakłócenie ekranu i zwykle nie jest wymagana, gdyż terminal normalnie już jest w trybie 80-kolumnowym.

Jeśli istnieją komendy do ustawiania i czyszczenia tabulatorów, to mogą być one podawane jako tbc (czyść wszystkie tabulatory) i hts (ustaw tabulator w bieżącej kolumnie w każdym wierszu). Jeśli do ustawienia tabulatorów wymagana jest bardziej skomplikowana sekwencja, to może być ona umieszczona w is2 lub if.

Opóźnienia i wypełnianie¶

Wiele starszych i wolniejszych terminali nie obsługuje ani XON/XOFF ani potwierdzania DTR. Wliczać w to można terminale hardcopy i pewne archaiczne CRT (np, DEC VT100). Wymagają one wypełniania znaków po pewnych ruchach kursora i zmianach ekranu.

Jeśli terminal używa potwierdzania xon/xoff dla sterowania przepływu (to znaczy automatycznie wysyła ^S do hosta gdy bufory wejściowe zbliżają się do przepełnienia), ustaw xon. Właściwość ta powstrzymuje emisję wypełniania. Możesz też ustawić ją dla mapowanych w pamięć urządzeń konsolowych, które efektywnie nie mają ograniczeń szybkości. Informacje wypełniające powinny wciąż być dołączane, aby procedury mogły lepiej decydować o względnych kosztach, lecz rzeczywiste znaki wypełnienia nie będą wysyłane.

Jeśli podane jest pb (szybkość wypełniania), to wypełnianie nie jest używane przy szybkościach niższych niż pb. Jeśli wpis nie zawiera szybkości, to emisja wypełniania w pełni zależy od xon.

Jeśli terminal wymaga innych niż zero znaków wypełniania, to powinno to być podawane jako pad. Z łańcucha pad używany jest jedynie pierwszy znak.

Linie statusu¶

Niektóre terminale posiadają dodatkowe `linie statusu', które nie są normalnie używane przez oprogramowanie (a więc nie liczą się jako właściwość lines terminala).

Najprostszym przypadkiem jest linia statusu, którą można adresować kursorem, lecz nie jest częścią podstawowego regionu przewijania ekranu; taką linię statusu posiada Heathkit H19 oraz 24 liniowe VT100 z 23-liniowym regionem przewijania ustawianym na starcie. Sytuacja ta jest wskazywana przez właściwość hs.

Niektóre terminale z liniami statusu wymagają specjalnych sekwencji aby dostać się do tej linii. Mogą one być wyrażane jako łańcuchy z pojedynczymi parametrami tsl, które pobierają pozycję kursora względem zerowej kolumny linii statusu. Właściwość fsl musi powracać do pozycji ekranu głównego, gdzie wywołano ostatnie tsl. Możliwe, że konieczne będzie osadzenie wartości łańcuchowych sc (zachowanie kursora) i rc (odtworzenie kursora) w tsl i fsl.

Linia statusu jest zazwyczaj tej samej szerokości co szerokość terminala. Gdy nie jest to prawdą, należy podać właściwość numeryczną wsl.

Komend kasowania linii statusu może być podawana jako dsl.

Wartość logiczna eslok określa, że sekwencje specjalne, tabulacje itp. działają w linii statusu normalnie.

Implementacja ncurses nie używa jeszcze żadnej z tych właściwości Są one tu udokumentowane na wypadek, gdyby stały się istotne.

Grafika liniowa¶

Wiele terminali posiada alternatywne zestawy znaków, przydatne do rysowania figur. Terminfo i curses mają wsparcie do rysowania znaków wspieranych przez VT100 plus niektóre znaki z AT&T 4410v1. Alternatywny zestaw znaków może być określony właściwością acsc.

Najlepszym sposobem na zdefiniowanie zestawu graficznego nowego urządzenia jest dodanie do kopii tej tabeli kolumny, podającej znak, jaki (po emisji między smacs/rmacs) został wyrenderowany jako odpowiadająca [kodowi] grafika. Następnie przeczytaj pary VT100/twój terminal z prawa na lewo--będzie to twój łańcuch ACSC.

Obsługa kolorów¶

Większość terminali kolorowych to albo terminale typu Tektronix, albo typu HP. Te pierwsze mają predefiniowany zestaw N kolorów (N zwykle wynosi 8) i mogą ustawiać w komórkach znakowych niezależnie kolor tła i pierwszego planu, tworząc N*N par kolorów. Na terminalach HP należy ustawiać każdą parę kolorów osobno (tło i pierwszy plan nie są ustawiane niezależnie). Można zdefiniować M par kolorów z 2*M dostępnych kolorów. Terminale zgodne z ANSI są typu Tektronix.

Pewne podstawowe właściwości kolorów są niezależne od metody kolorowania. Waściwości numeryczne colors i pairs określają maksymalną liczbę kolorów i par kolorów, które można naraz wyświetlać. Łańcuch op (para oryginalna) ustawia tło i pierwszy plan na domyślne wartości terminala. Łańcuch oc resetuje wszystkie kolory i pary kolorów na domyślne wartości terminala. Niektóre terminala (włącznie z wieloma emulatorami terminali PC) kasuje obszary ekranu z obecnym tłem, zamiast włączyć domyślne tło; powinny one posiadać właściwość logiczną bce.

Aby zmienić bieżący kolor pierwszego planu lub tła na terminalu typu Tektronix, należy użyć setaf (ustaw pierwszy plan ANSI) i setab (ustaw tło ANSI). Pobierają one jeden parametr--numer koloru. Dokumentacja SVr4 opisuje tylko setaf/setab; draft XPG4 mówi, że "Jeśli terminal obsługuje sekwencje specjalne ANSI do ustawiania tła i pierwszego planu, to powinny być one zakodowane odpowiednio jako setab i setaf. Jeśli terminal obsługuje inne sekewencje specjalne ustawiania tła i pierwszego planu, to powinny być one kodowane jako setb i setf. Funkcja vidputs() i funkcje odświeżania używają (o ile są zdefiniowane) setaf i setab."

Właściwości setaf/setab i setf/setb pobierają pojedynczy argument numeryczny. Wartości 0-7 są przenośnie zdefiniowane w sposób następujący (środkowa kolumna to symboliczne wartości #define z nagłówków bibliotek curses). Sprzęt terminala może mapować je jak chce, lecz wartości RGB określają normalne lokacje w przestrzeni kolorów. space.

Na terminalu typu HP używa się scp z numerem pary kolorów do ustawienia obecnej pary kolorów.

Na terminalu Tektronix może być obecna właściwość ccc. Wskazuje ona, że kolory można modyfikować. W tej sytuacji właściwość initc pobiera numer koloru (0 do colors-1) i trzy dalsze parametry, opisujące kolor. Parametry te są domyślnie interpretowane jako RGB. Jeśli obecna jest właściwość logiczna hls, to są one interpretowane jako parametry HLS (Hue, Lightness, Saturation). Zakresy zależą od terminala.

Na terminalu w rodzaju HP, initp może dawać możliwość zmieniania wartości pary kolorów. Pobiera 7 parametrów; numer pary kolorów (0 do max_pairs-1) oraz dwie trójki, opisujące najpierw tło, a potem pierwszy plan. Parametry te określają RGB lub HLS, zależnie od hls.

Na niektórych terminalach kolorowych, kolory kolidują z podświetleniami. Można zarejestrować te kolizje we właściwośći ncv. Jest to maska bitowa atrybutów, które nie mogą być używane przy włączonych kolorach. Odpowiedniość między atrybutami rozumianymi przez curses jest następująca:

Na przykład na wielu konsolach IBM PC atrybut podkreślenia koliduje z niebieskim kolorem pierwszego planu i nie jest dostępny w trybie kolorowym. Powinny więc mieć ustawione właściwość ncv na 2.

Curses SVr4 nie używają w ogóle ncv, ncurses rozpoznają je i optymalizują wyjście.

Różności¶

Jeśli terminal wymaga innego znaku wypełniania niż zero, to jest on podawany jako pad. Z łańcucha pad wykorzystywany jest tylko pierwszy znak. Jeśli terminal nie obsługuje znaku wypełniania, podaj npc. Zauważ, że ncurses implementuje zgodną z termcap zmienną PC; dlatego aplikacje mogą ustawiać tę wartość na coś innego niż zero, a ncurses spróbuje najpierw npc i użyje napms jeśli terminal nie posiada znaku wypełnienia.

Jeśli terminal może przesuwać w górę lub w dół o pół linii, to może to być określone przez hu (pół-linii w górę) i hd (pół-linii w dół). Jest to przede wszystkim przydatne dla indeksów górnych i dolnych w terminalach hardcopy. Jeśli terminal hardcopy potrafi przejść na następną stronę (eject to the next page) (tj. form feed), podaj to jako ff (zwykle control L).

Jeśli istnieje komenda do powtórzenia danego znaku podaną liczbę razy (aby zaoszczędzić na czasie transmisji dużej liczby takich samych znaków), można to określić parametryzowanym łańcuchem rep. Pierwszy parametr jest powtarzanym znakiem, a drugi liczbą powtórzeń. Tak więc tparm(repeat_char, 'x', 10) jest równoważne `xxxxxxxxxx'.

Jeśli terminal posiada ustawiany znak komendy, jak w TEKTRONIX, można to określić przez cmdch. Wybierany jest prototypowy znak komendy, używany we wszystkich właściwościach. Znak ten jest podawany przez właściwość cmdch. Na niektórych systemach uniksowych obsługiwana jest następująca konwencja: W środowisku szukana jest zmienna CC i jeśli zostanie znaleziona, wszystkie pojawienia znaku prototypowego są zamieniane na znak ze zmiennej środowiskowej.

Opisy terminala, które nie reprezentują konkretnych rodzajów znanych terminali, takie jak switch, dialup, patch i network, powinny zawierać właściwość gn (generic), aby programy mogły stwierdzić, że nie wiedzą jak rozmawiać z terminalem. (Właściwość ta nie tyczy się opisów terminali virtual, dla których znane są sekwencje specjalne.)

Jeśli terminal posiada klawisz ``meta'', który zachowuje się jak klawisz przesunięcia, ustawiający ósmy bit przesyłanego znaku, to fakt ten można wskazać z pomocą km. W przeciwnym wypadku, oprogramowanie założy, że 8-my bit jest bitem parzystości i zazwyczaj będzie czyszczony. Jeśli istnieją łańcuchy, włączające i wyłączające ten tryb ``meta'', to powinny być one określone jako smm i rmm.

Jeśli terminal ma więcej linii pamięci niż mieści się naraz na ekranie, to liczba tych linii powinna być określana przez lm. Nadanie wartości lm#0 określa, że liczba linii nie jest ustalona, lecz mimo to jest więcej pamięci niż linii ekranowych.

Jeśli terminal jest jednym z obsługiwanych przez uniksowy protokół wirtualnego terminala, to numer terminala może być podany jako vt.

Łańcuchy media copy, sterujące zewnętrzną drukarką, podłączoną do terminala mogą być podawane jako mc0: drukuj zawartość ekranu, mc4: wyłącz drukarkę i mc5: włącz drukarkę. Gdy drukarka jest włączona, tekst przesyłany do terminala będzie przesyłany na drukarkę. Nie jest zdefiniowane czy tekst ma być wtedy również wyświetlany na ekranie terminala. Wariacja mc5p pobiera jeden parametr i pozostawia drukarkę włączoną na tyle znaków, ile podano w parametrze; wyłączając następnie drukarkę. Parametr nie powinien przekraczać 255. Cały tekst, łącznie z mc4, jest podczas działania mc5p przezroczyście przekazywany drukarce.

Zaburzenia i uszkodzenie mózgu¶

Terminale, które nie zezwalają na wyświetlanie znaków tyldy, powinny wskazywać to przez hz.

Terminale, które ignorują line-feed po zawinięciu am, takie jak Concept i vt100 powinny wskazywać to przez xenl.

Jeśli do pozbycia się trybu wyróżnionego potrzebne jest el (zamiast zwyczajnego nadpisania na nim normalnego tekstu), należy podać xhp.

Terminale teleray, gdzie tabulacje zmieniają przesuwane znaki na spacje, powinny podawać xt (destruktywne tabulacje). Uwaga: zmienną, określającą to jest obecnie `dest_tabs_magic_smso'; w starszych wersjach było to teleray_glitch. To zaburzenie oznacza również, że nie jest możliwe ustawienie kursora na ``magicznym ciasteczku'', że do skasowania trybu wyróżnionego należy skasować lub wstawić linię. Implementacja ncurses ignoruje to.

Terminal Beehive Superbee, który nie potrafi poprawnie przesyłać znaków escape i control C ma właściwość xsb, określającą, że zamiast escape używany jest klawisz f1, a zamiast control C używane jest f2. (Problem ten występuje tylko w Superbee, zależnie od ROM.) Zauważ, że w starszych wersjach terminfo właściwość ta była nazywana `beehive_glitch'; obecnie jest to `no_esc_ctl_c'.

Inne problemy związane z konkretnymi terminalami można naprawić dodając dalsze właściwości typu xx.

Podobne terminale¶

Jeśli istnieją dwa bardzo podobne terminale, gdzie jeden może być zdefiniowany tak samo jak drugi, z pewnymi wyjątkami, to można wykorzystać właściwość use z nazwą podobnego terminala. Właściwości podane przed use przesłaniają te z typu wybranego przez use. Właściwości można anulować poprzez umieszczanie na lewo od definicji właściwości xx@, gdzie xx jest właściwością. Na przykład,

2621-nl, smkx@, rmkx@, use=2621,

definiuje 2621-nl, który nie posiada smkx, rmkx i z tego powodu nie włącza etykiet klawiszy funkcyjnych w trybie wizualnym. Jest to przydatne dla innych trybów terminala lub dla innych preferencji użytkownika.

Pułapki długich wpisów¶

Długie wpisy terminfo rzadko są problemem; żaden wpis terminfo nie osiągnął jeszcze nawet 4K maksimum przeznaczonego na tablicę łańcuchową. Niestety jednak, translacje termcap są bardziej ograniczone (do 1K). Z tego powodu, translacje termcap długich wpisów terminfo mogą powodować problemy.

Strony podręcznika man dla 4.3BSD i starszych wersji tgetent() mówią użytkownikowi, by alokował 1K bufor na wpis termcap. Wpis jest zakończony zerem przez bibliotekę termcap, więc bezpieczną długością wpisu termcap są 1023 bajty. Zależnie od tego, co robi dana aplikacja i biblioteka termcap i od tego gdzie w pliku termcap znajduje typ terminala szukany przez tgetent(), mogą dziać się różne rzeczy.

Niektóre biblioteki termcap drukują komunikat ostrzegawczy i kończą działanie; inne nie; inne skracają wpis do 1023 bajtów. Niektóre aplikacje alokują więcej niż wymagany 1K; inne nie.

Każdy wpis termcap zawiera związane ze sobą dwa ważne rozmiary: przed rozwinięciem "tc" i po rozwinięciu. "tc" jest właściwością, która fastryguje inny wpis termcap do końca bieżącego, aby dodać jego właściwości. Jeśli wpis termcap nie używa właściwości "tc", to oczywiście obydwa rozmiary są identyczne.

Długość przed rozwinięciem tc jest nawjażniejsza, gdyż dotyczy czegoś więcej niż tylko użytkowników konkretnego terminala. Jest to długość wpisu istniejącego w /etc/termcap minus para lewy ukośnik/nowa linia, które są pomijane przez tgetent() podczas odczytu. Niektóre biblioteki termcap obcinają również końcową nową linię (GNU termcap tego nie robi). Załóż teraz, że:

*

wpis termcap przed rozwinięciem ma więcej niż 1023 bajty,

*

aplikacja zaalokowała jedynie 1K,

*

biblioteka termcap (jak BSD/OS 1.1 i GNU) odczytuje cały wpis do bufora, niezależnie od długości, aby zobaczyć czy jest to ten wpis co trzeba,

*

a tgetent() szuka typu terminala, który jest albo długim wpisem, jak i znajduje się w pliku termcap za długim wpisem, albo nie istnieje w pliku w ogóle (więc tgetent() musi przeszukiwać cały plik termcap).

W tej sytuacji tgetent() nadpisze pamięć, być może również swój stos i prawdopodobnie rzuci korą. Programy typu telnet są szczególnie okaleczalne; nowoczesne telnety przekazują wartości jak typ terminala automatycznie. Wyniki są podobnie niechciane dla bibliotek termcap, jak SunOS 4.1.3 i Ultrix 4.4, które drukują ostrzeżenia gdy odczytują zbyt długie wpisy termcap. Jeśli biblioteka termcap obcina długie wpisy, jak OSF/1 3.0, to jest odporna na ten problem, lecz zwraca nieprawidłowe dane dla terminala.

Rozmiar "po rozwinięciu tc" ma podobne działanie na powyższe, lecz jedynie dla osób, które ustawiły TERM na ten typ terminala, gdyż tgetent() dokonuje rozwinięcia "tc" tylko jeśli znajdzie odpowiedni typ.

Ogólnie, wpis termcap, który jest dłuższy niż 1023 bajty może spowodować zrzut core, ostrzeżenia lub nieprawidłowe działanie. Jeśli jest zbyt długi przed rozwinięciem "tc", to będzie tak działał nawet dla użytkowników innych typów terminal, i tych których zmienna TERM nie posiada opisu w pliku termcap.

W trybie -C (tłumaczenia na termcap), implementacja tic(1) z ncurses daje ostrzeżenia gdy długość przed-tc wpisu termcap jest zbyt wielka. Opcja -c (check) sprawdza również rozwinięte (po tc) długości.

Kompatybilność binarna¶

Nie jest mądre liczyć na przenośność binarnych opisów terminfo między komercyjnymi wersjami uniksa. Problem polega na tym, że istnieją przynajmniej dwie wersje terminfo (pod HP-UX i AUX), które pochodzą z terminfo System V po SVr1 i dodały rozszerzone właściwości do tablicy łańcuchów które (binarnie) kolidują z rozszerzeniami Systemu V i XSI Curses.